<!DOCTYPE html>
<html lang="zh-CN" class=" ">

<head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

    <title>退款接口 - Powered by MinDoc</title>


    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <meta name="renderer" content="webkit">
    <meta name="author" content="Minho">
    <meta name="keywords" content="jeepay文档,xxpay文档,支付系统文档,开源聚合支付系统文档,优慧付 接口文档,签名规则">
    <meta name="description" content="签名规则-">


    <link href="./static/bootstrap.min.css" rel="stylesheet">

    <link href="./static/style.min.css" rel="stylesheet">
    <link href="./static/font-awesome.min.css" rel="stylesheet">
    <link href="./static/nprogress.css" rel="stylesheet">
    <link href="./static/kancloud.css" rel="stylesheet">
    <link href="./static/jstree.css" rel="stylesheet">
    <link href="./static/mermaid.css" rel="stylesheet">
    <link href="./static/sequence-diagram-min.css" rel="stylesheet">
    <link href="./static/editormd.preview.css" rel="stylesheet">
    <link href="./static/markdown.preview.css" rel="stylesheet">
    <link href="./static/github.css" rel="stylesheet">
    <link href="./static/katex.min.css" rel="stylesheet">
    <link href="./static/print.css" media="print" rel="stylesheet">

    <script type="text/javascript">window.book = { "identify": "jeepay_api" };</script>
    <link rel="stylesheet" href="./static/layer.css" id="layuicss-skinlayercss">
</head>

<body cz-shortcut-listen="true">
    <div class="m-manual manual-mode-view manual-reader">
        <header class="navbar navbar-static-top manual-head" role="banner">
            <div class="container-fluid">
                <div class="navbar-header pull-left manual-title">
                    <span class="slidebar" id="slidebar"><i class="fa fa-align-justify"></i></span>
                    <a  title="优慧付 接口文档" class="book-title">优慧付 接口文档</a>
                    <span style="font-size: 12px;font-weight: 100;"></span>
                </div>
            </div>
        </header>
        <article class="container-fluid manual-body">
            <div class="manual-left">
                <div class="manual-tab">
                    <div class="tab-navg">
                        <span data-mode="view" class="navg-item active"><i class="fa fa-align-justify"></i><b
                                class="text">目录</b></span>
                    </div>
                    <div class="tab-util">
                        <span class="manual-fullscreen-switch">
                            <b class="open fa fa-angle-right" title="展开"></b>
                            <b class="close fa fa-angle-left" title="关闭"></b>
                        </span>
                    </div>
                    <div class="tab-wrap">
                        <div class="tab-item manual-catalog">
                            <div class="catalog-list read-book-preview jstree jstree-1 jstree-default" id="sidebar"
                                role="tree" tabindex="0" aria-activedescendant="79" aria-busy="false">
                                <ul class="jstree-container-ul jstree-children jstree-wholerow-ul jstree-no-dots"
                                    role="group">
                                    <li role="treeitem" aria-selected="false" aria-level="1"
                                        aria-labelledby="466_anchor" aria-expanded="true" id="466"
                                        class="jstree-node  jstree-open">
                                        <div unselectable="on" role="presentation" class="jstree-wholerow">&nbsp;</div>
                                        <i class="jstree-icon jstree-ocl" role="presentation"></i><a
                                            class="jstree-anchor"
                                            title="支付网关" data-version="1641260071" id="466_anchor"><i
                                                class="jstree-icon jstree-themeicon jstree-themeicon-hidden"
                                                role="presentation"></i>支付网关</a>
                                        <ul role="group" class="jstree-children">
                                            <li role="treeitem" aria-selected="false" aria-level="2"
                                                aria-labelledby="76_anchor" id="76" class="jstree-node  jstree-leaf">
                                                <div unselectable="on" role="presentation" class="jstree-wholerow">
                                                    &nbsp;</div><i class="jstree-icon jstree-ocl"
                                                    role="presentation"></i><a class="jstree-anchor"
                                                    href="http://123.249.21.172/1dabsb5sgav0l.html"
                                                    tabindex="-1" title="签名规则" data-version="1694052478"
                                                    id="76_anchor"><i
                                                        class="jstree-icon jstree-themeicon jstree-themeicon-hidden"
                                                        role="presentation"></i>签名规则</a>
                                            </li>
                                            <li role="treeitem" aria-selected="false" aria-level="2"
                                                aria-labelledby="78_anchor" id="78" class="jstree-node  jstree-leaf">
                                                <div unselectable="on" role="presentation" class="jstree-wholerow">
                                                    &nbsp;</div><i class="jstree-icon jstree-ocl"
                                                    role="presentation"></i><a class="jstree-anchor"
                                                    href="http://123.249.21.172/1dabshnfu814r.html"
                                                    tabindex="-1" title="支付接口" data-version="1733730624"
                                                    id="78_anchor"><i
                                                        class="jstree-icon jstree-themeicon jstree-themeicon-hidden"
                                                        role="presentation"></i>支付接口</a>
                                            </li>
                                            <li role="treeitem" aria-selected="true" aria-level="2"
                                                aria-labelledby="79_anchor" id="79" class="jstree-node  jstree-leaf">
                                                <div unselectable="on" role="presentation"
                                                    class="jstree-wholerow jstree-wholerow-clicked">&nbsp;</div><i
                                                    class="jstree-icon jstree-ocl" role="presentation"></i><a
                                                    class="jstree-anchor jstree-clicked"
                                                    href="http://123.249.21.172/1dabsi9nqf03e.html"
                                                    tabindex="-1" title="退款接口" data-version="1736326230"
                                                    id="79_anchor"><i
                                                        class="jstree-icon jstree-themeicon jstree-themeicon-hidden"
                                                        role="presentation"></i>退款接口</a>
                                            </li>
                                        </ul>
                                    </li>
                                </ul>
                            </div>

                        </div>
                        
                    </div>
                </div>
               
            </div>
            <div class="manual-right">
                <div class="manual-article">

                    <div class="article-content">
                        <div class="article-body  markdown-body editormd-preview-container" id="page-content">
                            <article class="markdown-article-inner">
                                <div class="markdown-toc editormd-markdown-toc" style="height: 787px;">
                                    <ul class="markdown-toc-list">
                                        <li class="directory-item"><a class="directory-item-link directory-item-link-2"
                                                href="1dabsi9nqf03e.html#9m23dl"
                                                level="2">统一退款</a></li>
                                        <li class="directory-item"><a class="directory-item-link directory-item-link-2"
                                                href="1dabsi9nqf03e.html#8myigz"
                                                level="2">查询订单</a></li>
                                        <li class="directory-item directory-item-active"><a
                                                class="directory-item-link directory-item-link-2"
                                                href="1dabsi9nqf03e.html#5ybcc5"
                                                level="2">退款通知</a></li>
                                    </ul>
                                </div>
                                <div class="markdown-article">
                                    <h2 id="9m23dl" class="markdown-heading"><a name="9m23dl"
                                            class="reference-link"></a><span
                                            class="header-link octicon octicon-link"></span>统一退款</h2>
                                    <p class="line">商户业务系统通过统一退款接口发起退款请求，Jeepay支付网关会根据商户发起的支付订单号，找到对应到支付通道发起退款。</p>
                                    <blockquote class="default">
                                        <p class="line">接口说明</p>
                                    </blockquote>
                                    <p class="line">适用对象：<code>普通商户</code> <code>特约商户</code></p>
                                    <p class="line">请求URL：<a href="https://pay.hnmaster.cn/api/refund/refundOrder"
                                            target="_blank">https://pay.hnmaster.cn/api/refund/refundOrder</a></p>
                                    <p class="line">请求方式：<code>POST</code></p>
                                    <p class="line">请求类型：<code>application/json</code> 或
                                        <code>application/x-www-form-urlencoded</code>
                                    </p>
                                    <blockquote class="default">
                                        <p class="line">请求参数</p>
                                    </blockquote>
                                    <table>
                                        <thead>
                                            <tr>
                                                <th>字段名</th>
                                                <th>变量名</th>
                                                <th>必填</th>
                                                <th>类型</th>
                                                <th>示例值</th>
                                                <th>描述</th>
                                            </tr>
                                        </thead>
                                        <tbody>
                                            <tr>
                                                <td>商户号</td>
                                                <td>mchNo</td>
                                                <td>是</td>
                                                <td>String(64)</td>
                                                <td>M1621873433953</td>
                                                <td>商户号</td>
                                            </tr>
                                            <tr>
                                                <td>应用ID</td>
                                                <td>appId</td>
                                                <td>是</td>
                                                <td>String(64)</td>
                                                <td>60cc09bce4b0f1c0b83761c9</td>
                                                <td>应用ID</td>
                                            </tr>
                                            <tr>
                                                <td>支付订单号</td>
                                                <td>payOrderId</td>
                                                <td>是</td>
                                                <td>String(30)</td>
                                                <td>P20160427210604000490</td>
                                                <td>支付中心生成的订单号，与mchOrderNo二者传一即可</td>
                                            </tr>
                                            <tr>
                                                <td>商户订单号</td>
                                                <td>mchOrderNo</td>
                                                <td>是</td>
                                                <td>String(64)</td>
                                                <td>20160427210604000490</td>
                                                <td>商户生成的支付订单号，与payOrderId二者传一即可</td>
                                            </tr>
                                            <tr>
                                                <td>商户退款单号</td>
                                                <td>mchRefundNo</td>
                                                <td>是</td>
                                                <td>String(64)</td>
                                                <td>M27210632100491</td>
                                                <td>商户生成的退款单号</td>
                                            </tr>
                                            <tr>
                                                <td>退款金额</td>
                                                <td>refundAmount</td>
                                                <td>是</td>
                                                <td>int</td>
                                                <td>100</td>
                                                <td>退款金额,单位分</td>
                                            </tr>
                                            <tr>
                                                <td>货币代码</td>
                                                <td>currency</td>
                                                <td>是</td>
                                                <td>String(3)</td>
                                                <td>cny</td>
                                                <td>三位货币代码,人民币:cny</td>
                                            </tr>
                                            <tr>
                                                <td>退款原因</td>
                                                <td>refundReason</td>
                                                <td>是</td>
                                                <td>String(256)</td>
                                                <td>用户退货</td>
                                                <td>退款原因</td>
                                            </tr>
                                            <tr>
                                                <td>客户端IP</td>
                                                <td>clientIp</td>
                                                <td>否</td>
                                                <td>String(128)</td>
                                                <td>210.73.10.148</td>
                                                <td>客户端IPV4地址</td>
                                            </tr>
                                            <tr>
                                                <td>异步通知地址</td>
                                                <td>notifyUrl</td>
                                                <td>否</td>
                                                <td>String(128)</td>
                                                <td><a href="https://pay.hnmaster.cn/notify.htm"
                                                        target="_blank">https://pay.hnmaster.cn/notify.htm</a></td>
                                                <td>退款完成后回调该URL,只有传了该值才会发起回调</td>
                                            </tr>
                                            <tr>
                                                <td>渠道参数</td>
                                                <td>channelExtra</td>
                                                <td>否</td>
                                                <td>String(512)</td>
                                                <td>{“channel_ref”, “13920933111042”}</td>
                                                <td>特定渠道发起的额外参数,json格式字符串.详见渠道参数说明</td>
                                            </tr>
                                            <tr>
                                                <td>扩展参数</td>
                                                <td>extParam</td>
                                                <td>否</td>
                                                <td>String(512)</td>
                                                <td>134586944573118714</td>
                                                <td>商户扩展参数,回调时会原样返回</td>
                                            </tr>
                                            <tr>
                                                <td>请求时间</td>
                                                <td>reqTime</td>
                                                <td>是</td>
                                                <td>long</td>
                                                <td>1622016572190</td>
                                                <td>请求接口时间,13位时间戳</td>
                                            </tr>
                                            <tr>
                                                <td>接口版本</td>
                                                <td>version</td>
                                                <td>是</td>
                                                <td>String(3)</td>
                                                <td>1.0</td>
                                                <td>接口版本号，固定：1.0</td>
                                            </tr>
                                            <tr>
                                                <td>签名</td>
                                                <td>sign</td>
                                                <td>是</td>
                                                <td>String(32)</td>
                                                <td>C380BEC2BFD727A4B6845133519F3AD6</td>
                                                <td>签名值，详见签名算法</td>
                                            </tr>
                                            <tr>
                                                <td>签名类型</td>
                                                <td>signType</td>
                                                <td>是</td>
                                                <td>String(32)</td>
                                                <td>MD5</td>
                                                <td>签名类型，目前只支持MD5或RSA2方式</td>
                                            </tr>
                                        </tbody>
                                    </table>
                                    <p class="line"><code>请求示例数据</code></p>
                                    <pre class="hljs json"><code class="language-json">{
  <span class="hljs-attr"><span class="hljs-attr">"payOrderId"</span></span>: <span class="hljs-string"><span class="hljs-string">"P202106181104177050002"</span></span>,
  <span class="hljs-attr"><span class="hljs-attr">"extParam"</span></span>: <span class="hljs-string"><span class="hljs-string">""</span></span>,
  <span class="hljs-attr"><span class="hljs-attr">"mchOrderNo"</span></span>: <span class="hljs-string"><span class="hljs-string">""</span></span>,
  <span class="hljs-attr"><span class="hljs-attr">"refundReason"</span></span>: <span class="hljs-string"><span class="hljs-string">"退款测试"</span></span>,
  <span class="hljs-attr"><span class="hljs-attr">"sign"</span></span>: <span class="hljs-string"><span class="hljs-string">"2762CDB48D5179281DB6C0995E4EEDE0"</span></span>,
  <span class="hljs-attr"><span class="hljs-attr">"reqTime"</span></span>: <span class="hljs-string"><span class="hljs-string">"1624007315"</span></span>,
  <span class="hljs-attr"><span class="hljs-attr">"version"</span></span>: <span class="hljs-string"><span class="hljs-string">"1.0"</span></span>,
  <span class="hljs-attr"><span class="hljs-attr">"channelExtra"</span></span>: <span class="hljs-string"><span class="hljs-string">""</span></span>,
  <span class="hljs-attr"><span class="hljs-attr">"appId"</span></span>: <span class="hljs-string"><span class="hljs-string">"60cc09bce4b0f1c0b83761c9"</span></span>,
  <span class="hljs-attr"><span class="hljs-attr">"mchRefundNo"</span></span>: <span class="hljs-string"><span class="hljs-string">"mho1624007315478"</span></span>,
  <span class="hljs-attr"><span class="hljs-attr">"clientIp"</span></span>: <span class="hljs-string"><span class="hljs-string">"192.166.1.132"</span></span>,
  <span class="hljs-attr"><span class="hljs-attr">"notifyUrl"</span></span>: <span class="hljs-string"><span class="hljs-string">"https://pay.hnmaster.cn"</span></span>,
  <span class="hljs-attr"><span class="hljs-attr">"signType"</span></span>: <span class="hljs-string"><span class="hljs-string">"MD5"</span></span>,
  <span class="hljs-attr"><span class="hljs-attr">"currency"</span></span>: <span class="hljs-string"><span class="hljs-string">"cny"</span></span>,
  <span class="hljs-attr"><span class="hljs-attr">"mchNo"</span></span>: <span class="hljs-string"><span class="hljs-string">"M1623984572"</span></span>,
  <span class="hljs-attr"><span class="hljs-attr">"refundAmount"</span></span>: <span class="hljs-number"><span class="hljs-number">4</span></span>
}</code></pre>
                                    <blockquote class="default">
                                        <p class="line">返回参数</p>
                                    </blockquote>
                                    <table>
                                        <thead>
                                            <tr>
                                                <th>字段名</th>
                                                <th>变量名</th>
                                                <th>必填</th>
                                                <th>类型</th>
                                                <th>示例值</th>
                                                <th>描述</th>
                                            </tr>
                                        </thead>
                                        <tbody>
                                            <tr>
                                                <td>返回状态</td>
                                                <td>code</td>
                                                <td>是</td>
                                                <td>int</td>
                                                <td>0</td>
                                                <td>0-处理成功，其他-处理有误，详见错误码</td>
                                            </tr>
                                            <tr>
                                                <td>返回信息</td>
                                                <td>msg</td>
                                                <td>否</td>
                                                <td>String(128)</td>
                                                <td>签名失败</td>
                                                <td>具体错误原因，例如：签名失败、参数格式校验错误</td>
                                            </tr>
                                            <tr>
                                                <td>签名信息</td>
                                                <td>sign</td>
                                                <td>否</td>
                                                <td>String(32)</td>
                                                <td>CCD9083A6DAD9A2DA9F668C3D4517A84</td>
                                                <td>对data内数据签名,如data为空则不返回</td>
                                            </tr>
                                            <tr>
                                                <td>返回数据</td>
                                                <td>data</td>
                                                <td>否</td>
                                                <td>String(512)</td>
                                                <td>{}</td>
                                                <td>返回下单数据,json格式数据</td>
                                            </tr>
                                        </tbody>
                                    </table>
                                    <p class="line"><code>data数据格式</code></p>
                                    <table>
                                        <thead>
                                            <tr>
                                                <th>字段名</th>
                                                <th>变量名</th>
                                                <th>必填</th>
                                                <th>类型</th>
                                                <th>示例值</th>
                                                <th>描述</th>
                                            </tr>
                                        </thead>
                                        <tbody>
                                            <tr>
                                                <td>退款订单号</td>
                                                <td>refundOrderId</td>
                                                <td>是</td>
                                                <td>String(30)</td>
                                                <td>R202106181708358940000</td>
                                                <td>返回退款订单号</td>
                                            </tr>
                                            <tr>
                                                <td>商户退款单号</td>
                                                <td>mchRefundNo</td>
                                                <td>是</td>
                                                <td>String(30)</td>
                                                <td>mho1624007315478</td>
                                                <td>返回商户传入的退款单号</td>
                                            </tr>
                                            <tr>
                                                <td>退款状态</td>
                                                <td>state</td>
                                                <td>是</td>
                                                <td>int</td>
                                                <td>2</td>
                                                <td>退款状态<br>0-订单生成<br>1-退款中<br>2-退款成功<br>3-退款失败<br>4-退款关闭</td>
                                            </tr>
                                            <tr>
                                                <td>渠道退款单号</td>
                                                <td>channelOrderNo</td>
                                                <td>否</td>
                                                <td>String</td>
                                                <td>20160427210604000490</td>
                                                <td>对应渠道的退款单号</td>
                                            </tr>
                                            <tr>
                                                <td>渠道错误码</td>
                                                <td>errCode</td>
                                                <td>否</td>
                                                <td>String</td>
                                                <td>ACQ.PAYMENT_AUTH_CODE_INVALID</td>
                                                <td>上游渠道返回的错误码</td>
                                            </tr>
                                            <tr>
                                                <td>渠道错误描述</td>
                                                <td>errMsg</td>
                                                <td>否</td>
                                                <td>String</td>
                                                <td>Business Failed 失败</td>
                                                <td>上游渠道返回的错误描述</td>
                                            </tr>
                                        </tbody>
                                    </table>
                                    <p class="line"><code>返回示例数据</code></p>
                                    <pre class="hljs json"><code class="language-json">{
  <span class="hljs-attr"><span class="hljs-attr">"code"</span></span>: <span class="hljs-number"><span class="hljs-number">0</span></span>,
  <span class="hljs-attr"><span class="hljs-attr">"data"</span></span>: {
    <span class="hljs-attr"><span class="hljs-attr">"channelOrderNo"</span></span>: <span class="hljs-string"><span class="hljs-string">"2021061822001423031419593035"</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"mchRefundNo"</span></span>: <span class="hljs-string"><span class="hljs-string">"mho1624007315478"</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"payAmount"</span></span>: <span class="hljs-number"><span class="hljs-number">58</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"refundAmount"</span></span>: <span class="hljs-number"><span class="hljs-number">4</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"refundOrderId"</span></span>: <span class="hljs-string"><span class="hljs-string">"R202106181708358940000"</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"state"</span></span>: <span class="hljs-number"><span class="hljs-number">2</span></span>
  },
  <span class="hljs-attr"><span class="hljs-attr">"msg"</span></span>: <span class="hljs-string"><span class="hljs-string">"SUCCESS"</span></span>,
  <span class="hljs-attr"><span class="hljs-attr">"sign"</span></span>: <span class="hljs-string"><span class="hljs-string">"2843B811B7A75D56B7D1950362820875"</span></span>
}</code></pre>
                                    <h2 id="8myigz" class="markdown-heading"><a name="8myigz"
                                            class="reference-link"></a><span
                                            class="header-link octicon octicon-link"></span>查询订单</h2>
                                    <p class="line">商户通过该接口查询退款订单，支付网关会返回订单最新的数据</p>
                                    <blockquote class="default">
                                        <p class="line">接口说明</p>
                                    </blockquote>
                                    <p class="line">适用对象：<code>普通商户</code> <code>特约商户</code></p>
                                    <p class="line">请求URL：<a href="https://pay.hnmaster.cn/api/refund/query"
                                            target="_blank">https://pay.hnmaster.cn/api/refund/query</a></p>
                                    <p class="line">请求方式：<code>POST</code></p>
                                    <p class="line">请求类型：<code>application/json</code> 或
                                        <code>application/x-www-form-urlencoded</code>
                                    </p>
                                    <blockquote class="default">
                                        <p class="line">请求参数</p>
                                    </blockquote>
                                    <table>
                                        <thead>
                                            <tr>
                                                <th>字段名</th>
                                                <th>变量名</th>
                                                <th>必填</th>
                                                <th>类型</th>
                                                <th>示例值</th>
                                                <th>描述</th>
                                            </tr>
                                        </thead>
                                        <tbody>
                                            <tr>
                                                <td>商户号</td>
                                                <td>mchNo</td>
                                                <td>是</td>
                                                <td>String(64)</td>
                                                <td>M1621873433953</td>
                                                <td>商户号</td>
                                            </tr>
                                            <tr>
                                                <td>应用ID</td>
                                                <td>appId</td>
                                                <td>是</td>
                                                <td>String(64)</td>
                                                <td>60cc09bce4b0f1c0b83761c9</td>
                                                <td>应用ID</td>
                                            </tr>
                                            <tr>
                                                <td>退款订单号</td>
                                                <td>refundOrderId</td>
                                                <td>是</td>
                                                <td>String(30)</td>
                                                <td>R20160427210604000490</td>
                                                <td>支付中心生成的退款单号，与mchRefundNo二者传一即可</td>
                                            </tr>
                                            <tr>
                                                <td>商户退款单号</td>
                                                <td>mchRefundNo</td>
                                                <td>是</td>
                                                <td>String(64)</td>
                                                <td>20160427210604000490</td>
                                                <td>商户生成的退款单号，与refundOrderId二者传一即可</td>
                                            </tr>
                                            <tr>
                                                <td>请求时间</td>
                                                <td>reqTime</td>
                                                <td>是</td>
                                                <td>long</td>
                                                <td>1622016572190</td>
                                                <td>请求接口时间,13位时间戳</td>
                                            </tr>
                                            <tr>
                                                <td>接口版本</td>
                                                <td>version</td>
                                                <td>是</td>
                                                <td>String(3)</td>
                                                <td>1.0</td>
                                                <td>接口版本号，固定：1.0</td>
                                            </tr>
                                            <tr>
                                                <td>签名</td>
                                                <td>sign</td>
                                                <td>是</td>
                                                <td>String(32)</td>
                                                <td>C380BEC2BFD727A4B6845133519F3AD6</td>
                                                <td>签名值，详见签名算法</td>
                                            </tr>
                                            <tr>
                                                <td>签名类型</td>
                                                <td>signType</td>
                                                <td>是</td>
                                                <td>String(32)</td>
                                                <td>MD5</td>
                                                <td>签名类型，目前只支持MD5或RSA2方式</td>
                                            </tr>
                                        </tbody>
                                    </table>
                                    <p class="line"><code>请求示例数据</code></p>
                                    <pre class="hljs json"><code class="language-json">{
  <span class="hljs-attr"><span class="hljs-attr">"refundOrderId"</span></span>: <span class="hljs-string"><span class="hljs-string">"P202106181105527690009"</span></span>,
  <span class="hljs-attr"><span class="hljs-attr">"appId"</span></span>: <span class="hljs-string"><span class="hljs-string">"60cc09bce4b0f1c0b83761c9"</span></span>,
  <span class="hljs-attr"><span class="hljs-attr">"sign"</span></span>: <span class="hljs-string"><span class="hljs-string">"1484293FCAEAFE11DEC8949DB6B525A9"</span></span>,
  <span class="hljs-attr"><span class="hljs-attr">"signType"</span></span>: <span class="hljs-string"><span class="hljs-string">"MD5"</span></span>,
  <span class="hljs-attr"><span class="hljs-attr">"reqTime"</span></span>: <span class="hljs-string"><span class="hljs-string">"1624008199"</span></span>,
  <span class="hljs-attr"><span class="hljs-attr">"mchNo"</span></span>: <span class="hljs-string"><span class="hljs-string">"M1623984572"</span></span>,
  <span class="hljs-attr"><span class="hljs-attr">"version"</span></span>: <span class="hljs-string"><span class="hljs-string">"1.0"</span></span>
}</code></pre>
                                    <table>
                                        <thead>
                                            <tr>
                                                <th>字段名</th>
                                                <th>变量名</th>
                                                <th>必填</th>
                                                <th>类型</th>
                                                <th>示例值</th>
                                                <th>描述</th>
                                            </tr>
                                        </thead>
                                        <tbody>
                                            <tr>
                                                <td>返回状态</td>
                                                <td>code</td>
                                                <td>是</td>
                                                <td>int</td>
                                                <td>0</td>
                                                <td>0-处理成功，其他-处理有误，详见错误码</td>
                                            </tr>
                                            <tr>
                                                <td>返回信息</td>
                                                <td>msg</td>
                                                <td>否</td>
                                                <td>String(128)</td>
                                                <td>签名失败</td>
                                                <td>具体错误原因，例如：签名失败、参数格式校验错误</td>
                                            </tr>
                                            <tr>
                                                <td>签名信息</td>
                                                <td>sign</td>
                                                <td>否</td>
                                                <td>String(32)</td>
                                                <td>CCD9083A6DAD9A2DA9F668C3D4517A84</td>
                                                <td>对data内数据签名,如data为空则不返回</td>
                                            </tr>
                                            <tr>
                                                <td>返回数据</td>
                                                <td>data</td>
                                                <td>否</td>
                                                <td>String(512)</td>
                                                <td>{}</td>
                                                <td>返回下单数据,json格式数据</td>
                                            </tr>
                                        </tbody>
                                    </table>
                                    <p class="line"><code>data数据格式</code></p>
                                    <table>
                                        <thead>
                                            <tr>
                                                <th>字段名</th>
                                                <th>变量名</th>
                                                <th>必填</th>
                                                <th>类型</th>
                                                <th>示例值</th>
                                                <th>描述</th>
                                            </tr>
                                        </thead>
                                        <tbody>
                                            <tr>
                                                <td>退款订单号</td>
                                                <td>refundOrderId</td>
                                                <td>是</td>
                                                <td>String(30)</td>
                                                <td>R20160427210604000490</td>
                                                <td>支付中心生成的退款单号</td>
                                            </tr>
                                            <tr>
                                                <td>支付订单号</td>
                                                <td>payOrderId</td>
                                                <td>是</td>
                                                <td>String(30)</td>
                                                <td>P12021022311124442600</td>
                                                <td>返回支付系统订单号</td>
                                            </tr>
                                            <tr>
                                                <td>商户号</td>
                                                <td>mchNo</td>
                                                <td>是</td>
                                                <td>String(30)</td>
                                                <td>M1621873433953</td>
                                                <td>商户号</td>
                                            </tr>
                                            <tr>
                                                <td>应用ID</td>
                                                <td>appId</td>
                                                <td>是</td>
                                                <td>String(24)</td>
                                                <td>60cc09bce4b0f1c0b83761c9</td>
                                                <td>应用ID</td>
                                            </tr>
                                            <tr>
                                                <td>商户退款单号</td>
                                                <td>mchRefundNo</td>
                                                <td>是</td>
                                                <td>String(30)</td>
                                                <td>20160427210604000490</td>
                                                <td>商户生成的退款单号</td>
                                            </tr>
                                            <tr>
                                                <td>支付金额</td>
                                                <td>payAmount</td>
                                                <td>是</td>
                                                <td>int</td>
                                                <td>100</td>
                                                <td>支付金额,单位分</td>
                                            </tr>
                                            <tr>
                                                <td>退款金额</td>
                                                <td>refundAmount</td>
                                                <td>是</td>
                                                <td>int</td>
                                                <td>100</td>
                                                <td>退款金额,单位分</td>
                                            </tr>
                                            <tr>
                                                <td>货币代码</td>
                                                <td>currency</td>
                                                <td>是</td>
                                                <td>String(3)</td>
                                                <td>cny</td>
                                                <td>三位货币代码,人民币:cny</td>
                                            </tr>
                                            <tr>
                                                <td>退款状态</td>
                                                <td>state</td>
                                                <td>是</td>
                                                <td>int</td>
                                                <td>2</td>
                                                <td>退款状态<br>0-订单生成<br>1-退款中<br>2-退款成功<br>3-退款失败<br>4-退款关闭</td>
                                            </tr>
                                            <tr>
                                                <td>渠道订单号</td>
                                                <td>channelOrderNo</td>
                                                <td>否</td>
                                                <td>String</td>
                                                <td>20160427210604000490</td>
                                                <td>对应渠道的订单号</td>
                                            </tr>
                                            <tr>
                                                <td>渠道错误码</td>
                                                <td>errCode</td>
                                                <td>否</td>
                                                <td>String</td>
                                                <td>1002</td>
                                                <td>渠道返回错误码</td>
                                            </tr>
                                            <tr>
                                                <td>渠道错误描述</td>
                                                <td>errMsg</td>
                                                <td>否</td>
                                                <td>String</td>
                                                <td>134586944573118714</td>
                                                <td>渠道返回错误描述</td>
                                            </tr>
                                            <tr>
                                                <td>扩展参数</td>
                                                <td>extParam</td>
                                                <td>否</td>
                                                <td>String(512)</td>
                                                <td>134586944573118714</td>
                                                <td>商户扩展参数,回调时会原样返回</td>
                                            </tr>
                                            <tr>
                                                <td>创建时间</td>
                                                <td>createdAt</td>
                                                <td>是</td>
                                                <td>long</td>
                                                <td>1622016572190</td>
                                                <td>订单创建时间,13位时间戳</td>
                                            </tr>
                                            <tr>
                                                <td>成功时间</td>
                                                <td>successTime</td>
                                                <td>否</td>
                                                <td>long</td>
                                                <td>1622016572190</td>
                                                <td>订单支付成功时间,13位时间戳</td>
                                            </tr>
                                        </tbody>
                                    </table>
                                    <p class="line"><code>返回示例数据</code></p>
                                    <pre class="hljs json"><code class="language-json">{
  <span class="hljs-attr"><span class="hljs-attr">"code"</span></span>: <span class="hljs-number"><span class="hljs-number">0</span></span>,
  <span class="hljs-attr"><span class="hljs-attr">"data"</span></span>: {
    <span class="hljs-attr"><span class="hljs-attr">"appId"</span></span>: <span class="hljs-string"><span class="hljs-string">"60cc09bce4b0f1c0b83761c9"</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"channelOrderNo"</span></span>: <span class="hljs-string"><span class="hljs-string">"2021061822001423031419593035"</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"createdAt"</span></span>: <span class="hljs-number"><span class="hljs-number">1623985552769</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"currency"</span></span>: <span class="hljs-string"><span class="hljs-string">"cny"</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"extParam"</span></span>: <span class="hljs-string"><span class="hljs-string">""</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"mchNo"</span></span>: <span class="hljs-string"><span class="hljs-string">"M1623984572"</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"mchRefundNo"</span></span>: <span class="hljs-string"><span class="hljs-string">"mho1623985552430"</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"payAmount"</span></span>: <span class="hljs-number"><span class="hljs-number">58</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"payOrderId"</span></span>: <span class="hljs-string"><span class="hljs-string">"P202106181104177050002"</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"refundAmount"</span></span>: <span class="hljs-number"><span class="hljs-number">4</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"refundOrderId"</span></span>: <span class="hljs-string"><span class="hljs-string">"P202106181105527690009"</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"state"</span></span>: <span class="hljs-number"><span class="hljs-number">2</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"successTime"</span></span>: <span class="hljs-number"><span class="hljs-number">1623985554000</span></span>
  },
  <span class="hljs-attr"><span class="hljs-attr">"msg"</span></span>: <span class="hljs-string"><span class="hljs-string">"SUCCESS"</span></span>,
  <span class="hljs-attr"><span class="hljs-attr">"sign"</span></span>: <span class="hljs-string"><span class="hljs-string">"E3F9F008FC5EF84BD782CCC7BE69DC5E"</span></span>
}</code></pre>
                                    <h2 id="5ybcc5" class="markdown-heading"><a name="5ybcc5"
                                            class="reference-link"></a><span
                                            class="header-link octicon octicon-link"></span>退款通知</h2>
                                    <p class="line">当退款完成时(成功或失败)，支付网关会向商户系统发起回调通知。如果商户系统没有正确返回，支付网关会延迟再次通知。</p>
                                    <blockquote class="default">
                                        <p class="line">接口说明</p>
                                    </blockquote>
                                    <p class="line">适用对象：<code>普通商户</code> <code>特约商户</code></p>
                                    <p class="line">请求URL：该链接是通过统一退款接口提交的参数notifyUrl设置，如果无法访问链接，商户系统将无法接收到支付中心的通知。</p>
                                    <p class="line">请求方式：<code>POST</code></p>
                                    <p class="line">请求类型：<code>application/x-www-form-urlencoded</code></p>
                                    <blockquote class="default">
                                        <p class="line">通知参数</p>
                                    </blockquote>
                                    <table>
                                        <thead>
                                            <tr>
                                                <th>字段名</th>
                                                <th>变量名</th>
                                                <th>必填</th>
                                                <th>类型</th>
                                                <th>示例值</th>
                                                <th>描述</th>
                                            </tr>
                                        </thead>
                                        <tbody>
                                            <tr>
                                                <td>退款订单号</td>
                                                <td>refundOrderId</td>
                                                <td>是</td>
                                                <td>String(30)</td>
                                                <td>R20160427210604000490</td>
                                                <td>支付中心生成的退款单号</td>
                                            </tr>
                                            <tr>
                                                <td>支付订单号</td>
                                                <td>payOrderId</td>
                                                <td>是</td>
                                                <td>String(30)</td>
                                                <td>P12021022311124442600</td>
                                                <td>返回支付系统订单号</td>
                                            </tr>
                                            <tr>
                                                <td>商户号</td>
                                                <td>mchNo</td>
                                                <td>是</td>
                                                <td>String(30)</td>
                                                <td>M1621873433953</td>
                                                <td>商户号</td>
                                            </tr>
                                            <tr>
                                                <td>应用ID</td>
                                                <td>appId</td>
                                                <td>是</td>
                                                <td>String(24)</td>
                                                <td>60cc09bce4b0f1c0b83761c9</td>
                                                <td>应用ID</td>
                                            </tr>
                                            <tr>
                                                <td>商户退款单号</td>
                                                <td>mchRefundNo</td>
                                                <td>是</td>
                                                <td>String(30)</td>
                                                <td>20160427210604000490</td>
                                                <td>商户生成的退款单号</td>
                                            </tr>
                                            <tr>
                                                <td>支付金额</td>
                                                <td>payAmount</td>
                                                <td>是</td>
                                                <td>int</td>
                                                <td>100</td>
                                                <td>支付金额,单位分</td>
                                            </tr>
                                            <tr>
                                                <td>退款金额</td>
                                                <td>refundAmount</td>
                                                <td>是</td>
                                                <td>int</td>
                                                <td>100</td>
                                                <td>退款金额,单位分</td>
                                            </tr>
                                            <tr>
                                                <td>货币代码</td>
                                                <td>currency</td>
                                                <td>是</td>
                                                <td>String(3)</td>
                                                <td>cny</td>
                                                <td>三位货币代码,人民币:cny</td>
                                            </tr>
                                            <tr>
                                                <td>退款状态</td>
                                                <td>state</td>
                                                <td>是</td>
                                                <td>int</td>
                                                <td>2</td>
                                                <td>退款状态<br>0-订单生成<br>1-退款中<br>2-退款成功<br>3-退款失败<br>4-退款关闭</td>
                                            </tr>
                                            <tr>
                                                <td>渠道订单号</td>
                                                <td>channelOrderNo</td>
                                                <td>否</td>
                                                <td>String</td>
                                                <td>20160427210604000490</td>
                                                <td>对应渠道的订单号</td>
                                            </tr>
                                            <tr>
                                                <td>渠道错误码</td>
                                                <td>errCode</td>
                                                <td>否</td>
                                                <td>String</td>
                                                <td>1002</td>
                                                <td>渠道返回错误码</td>
                                            </tr>
                                            <tr>
                                                <td>渠道错误描述</td>
                                                <td>errMsg</td>
                                                <td>否</td>
                                                <td>String</td>
                                                <td>134586944573118714</td>
                                                <td>渠道返回错误描述</td>
                                            </tr>
                                            <tr>
                                                <td>扩展参数</td>
                                                <td>extParam</td>
                                                <td>否</td>
                                                <td>String(512)</td>
                                                <td>134586944573118714</td>
                                                <td>商户扩展参数,回调时会原样返回</td>
                                            </tr>
                                            <tr>
                                                <td>创建时间</td>
                                                <td>createdAt</td>
                                                <td>是</td>
                                                <td>long</td>
                                                <td>1622016572190</td>
                                                <td>订单创建时间,13位时间戳</td>
                                            </tr>
                                            <tr>
                                                <td>成功时间</td>
                                                <td>successTime</td>
                                                <td>否</td>
                                                <td>long</td>
                                                <td>1622016572190</td>
                                                <td>订单支付成功时间,13位时间戳</td>
                                            </tr>
                                            <tr>
                                                <td>通知请求时间</td>
                                                <td>reqTime</td>
                                                <td>是</td>
                                                <td>String(30)</td>
                                                <td>1622016572190</td>
                                                <td>通知请求时间，,13位时间戳</td>
                                            </tr>
                                            <tr>
                                                <td>签名</td>
                                                <td>sign</td>
                                                <td>是</td>
                                                <td>String(32)</td>
                                                <td>C380BEC2BFD727A4B6845133519F3AD6</td>
                                                <td>签名值，详见签名算法</td>
                                            </tr>
                                        </tbody>
                                    </table>
                                    <p class="line">&gt; 返回结果</p>
                                    <p class="line">业务系统处理后同步返回给支付中心，返回字符串 success
                                        则表示成功，返回非success则表示处理失败，支付中心会再次通知业务系统。（通知频率为0/30/60/90/120/150,单位：秒）</p>
                                    <p class="line"><code>注意：返回的字符串必须是小写，且前后不能有空格和换行符。</code></p>
                                    <p class="line"><code>通知示例数据</code></p>
                                    <pre class="hljs json"><code class="language-json">{
    <span class="hljs-attr"><span class="hljs-attr">"appId"</span></span>: <span class="hljs-string"><span class="hljs-string">"60cc09bce4b0f1c0b83761c9"</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"channelOrderNo"</span></span>: <span class="hljs-string"><span class="hljs-string">"2021061822001423031419593035"</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"createdAt"</span></span>: <span class="hljs-number"><span class="hljs-number">1623985552769</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"currency"</span></span>: <span class="hljs-string"><span class="hljs-string">"cny"</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"extParam"</span></span>: <span class="hljs-string"><span class="hljs-string">""</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"mchNo"</span></span>: <span class="hljs-string"><span class="hljs-string">"M1623984572"</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"mchRefundNo"</span></span>: <span class="hljs-string"><span class="hljs-string">"mho1623985552430"</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"payAmount"</span></span>: <span class="hljs-number"><span class="hljs-number">58</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"payOrderId"</span></span>: <span class="hljs-string"><span class="hljs-string">"P202106181104177050002"</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"refundAmount"</span></span>: <span class="hljs-number"><span class="hljs-number">4</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"refundOrderId"</span></span>: <span class="hljs-string"><span class="hljs-string">"P202106181105527690009"</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"state"</span></span>: <span class="hljs-number"><span class="hljs-number">2</span></span>,
    <span class="hljs-attr"><span class="hljs-attr">"successTime"</span></span>: <span class="hljs-number"><span class="hljs-number">1623985554000</span></span>
}</code></pre>
                                    <div class="wiki-bottom"></div>
                                </div>


                            </article>
                        </div>

                        <div class="jump-top">
                            <a href="javascript:;" class="view-backtop active"><i class="fa fa-arrow-up"
                                    aria-hidden="true"></i></a>
                        </div>
                    </div>

                </div>
            </div>
            <div class="manual-progress"><b class="progress-bar"></b></div>
            <div id="manual-vsplitbar" unselectable="on"
                style="                        z-index:301;                        position: absolute;                        user-select: none;                        cursor: col-resize;                        left: 275px;                        height: 100%;                        display: block;                        width: 3px;">
                <a href="javascript:void(0)" accesskey="" tabindex="0" title="vsplitbar"></a>
            </div>
        </article>
        <div class="manual-mask"></div>
    </div>




    <script src="./static/jquery.min.js"></script>
    <script src="./static/bootstrap.min.js"></script>
    <script src="./static/jquery.form.js" type="text/javascript"></script>
    <script src="./static/layer.js" type="text/javascript"></script>
    <script src="./static/jstree.min.js" type="text/javascript"></script>
    <script src="./static/nprogress.js" type="text/javascript"></script>
    <script src="./static/highlight.js" type="text/javascript"></script>
    <script src="./static/jquery.highlight.js" type="text/javascript"></script>
    <script src="./static/kancloud.js" type="text/javascript"></script>
    <script src="./static/splitbar.js" type="text/javascript"></script>
   


</body>

</html>